<?php

namespace Platform\Controller;

/**
 * @apiDefine ApiErrorExample
 *
 * @apiErrorExample 失败返回
 * HTTP/1.1 200 OK
 * {
 *  "code": 100,
 *  "info": "",
 *  "data": "",
 * }
 *
 */

/**
 * @apiDefine ApiSuccessExample
 *
 * @apiSuccessExample 成功返回
 * HTTP/1.1 200 OK
 * {
 *  "data": "",
 *  "info": "",
 *  "code": 200,
 * }
 *
 */

class ShowController extends BaseController {

	/**
	 * @api {post}  /platform/show/banner 展示banner图片组
	 * @apiVersion 1.0.0
	 * @apiName banner
	 * @apiGroup 展示
	 *
	 * @apiParam {string} app_id 平台的应用ID
	 *
	 * @apiSuccess {String} info  提示信息
	 * @apiSuccess {Number} code  错误码,200代表正常
	 * @apiSuccess {Object} data  数据
	 * @apiSuccess {Number} data.count  banner图片个数
	 * @apiSuccess {List} data.lists  banner图片列表
	 * @apiSuccess {String} data.lists.image  图片地址
	 * @apiSuccess {String} data.lists.title  图片标题
	 * @apiSuccess {String} data.lists.link   链接地址
	 *
	 * @apiUse ApiSuccessExample
	 *
	 * @apiUse ApiErrorExample
	 */
	public function banner() {
		# code...
	}

	/**
	 * @api {post}  /platform/show/recommend 展示推荐视频
	 * @apiVersion 1.0.0
	 * @apiName recommend
	 * @apiGroup 展示
	 *
	 * @apiParam {string} app_id 平台的应用ID
	 *
	 * @apiSuccess {String} info  提示信息
	 * @apiSuccess {Number} code  错误码,200代表正常
	 * @apiSuccess {Object} data  数据
	 * @apiSuccess {Number} data.count  视频个数
	 * @apiSuccess {List} data.lists    视频列表
	 *
	 * @apiUse ApiSuccessExample
	 *
	 * @apiUse ApiErrorExample
	 */
	public function recommend($value = '') {
		# code...
	}

}